From: Tim Janik <timj@src.gnome.org>
Date: Fri, 20 Jun 2008 11:10:48 +0000 (+0000)
Subject: Document gtk_dialog_get_action_area(), gtk_dialog_pack_start() and gtk_dialog_pack_end()
X-Git-Tag: archive/raspbian/4.4.1+ds1-2+rpi1~1^2~428^2^2~31833
X-Git-Url: https://dgit.raspbian.org/%22http://www.example.com/cgi/%22/%22http:/www.example.com/cgi/%22?a=commitdiff_plain;h=dd8ea211421db11e8fa07178494f4bde3897972f;p=gtk4.git

Document gtk_dialog_get_action_area(), gtk_dialog_pack_start() and gtk_dialog_pack_end()

* gtk/gtkdialog.c: Add missing documentation for new fucntions.

svn path=/trunk/; revision=20631
---

diff --git a/gtk/gtkdialog.c b/gtk/gtkdialog.c
index 2f858fcbd9..6aac6c95d6 100644
--- a/gtk/gtkdialog.c
+++ b/gtk/gtkdialog.c
@@ -1479,6 +1479,16 @@ gtk_dialog_buildable_custom_finished (GtkBuildable *buildable,
   g_slice_free (ActionWidgetsSubParserData, parser_data);
 }
 
+/**
+ * gtk_dialog_get_action_area:
+ * @dialog: a #GtkDialog
+ *
+ * Returns the action area of @dialog.
+ *
+ * Returns: a #GtkHButtonBox.
+ *
+ * Since: GSEAL-branch
+ **/
 GtkHButtonBox *
 gtk_dialog_get_action_area (GtkDialog *dialog)
 {
@@ -1487,6 +1497,19 @@ gtk_dialog_get_action_area (GtkDialog *dialog)
   return dialog->action_area;
 }
 
+/**
+ * gtk_dialog_pack_start:
+ * @dialog: a #GtkDialog
+ * @widget: #GtkWidget to be added to @dialog.
+ * @expand: %TRUE if @widget should take all extra space.
+ * @fill: %TRUE if all space given should be used by @widget
+ * @padding: extra pixels to put between @widget and its neighbors
+ *
+ * This function similar to gtk_box_pack_start() packs @widget
+ * with reference to the start of @dialog.
+ *
+ * Since: GSEAL-branch
+ **/
 void
 gtk_dialog_pack_start (GtkDialog *dialog,
 		       GtkWidget *widget,
@@ -1501,6 +1524,19 @@ gtk_dialog_pack_start (GtkDialog *dialog,
 		      widget, expand, fill, padding);
 }
 
+/**
+ * gtk_dialog_pack_end:
+ * @dialog: a #GtkDialog
+ * @widget: #GtkWidget to be added to @dialog.
+ * @expand: %TRUE if @widget should take all extra space.
+ * @fill: %TRUE if all space given should be used by @widget
+ * @padding: extra pixels to put between @widget and its neighbors
+ *
+ * This function similar to gtk_box_pack_end() packs @widget
+ * with reference to the end of @dialog.
+ *
+ * Since: GSEAL-branch
+ **/
 void
 gtk_dialog_pack_end (GtkDialog *dialog,
 		     GtkWidget *widget,